(rasekhoon.net)
------------------------------------
 ComingNext & Coming Next B for N97
------------------------------------
This widget was originally created by Dr. Cochambre and was extended by 
Oxidative <X_X_L@gmx.net>. It will display the next 8 upcoming events 
on your N97 homescreen. It consists of two seperate widgets, each displaying
4 events.

For more info or to report bugs, please refere to 
http://sourceforge.net/projects/comingnext

You can change the appearance (background color, font color, font size etc.) 
and settings by modifying the widget:

  1. rename comingNext.wgz to comingNext.zip
  2. edit comingNext.zip/comingNext/index.html and customize the settings
     at the top of the document. For example, to change the background to 
     a solid red color, set:
       .background { ... background-color:#ff0000; ... }
       useBackgroundImage = false;
  3. rename comingNext.zip back to comingNext.wgz
  4. do the same for comingNextB.wgz

To add your custom background/fake transparency, follow these steps:

  1. rename comingNext.wgz to comingNext.zip
  2. replace comingNext.zip/comingNext/background_landscape.png and 
     background_portrait.png with your desired background.
  3. rename comingNext.zip back to comingNext.wgz
  4. do the same for comingNextB.wgz
  
I recommend to use a program to make a screenshot of your current 
homescreen background, then use a painting program like GIMP to 
cut out the pieces you need. Use background_mask_landscape.png and 
background_mask_portrait.png for guidance on what parts of the screen are
used by widgets.


known limitations:
------------------
- ToDos might show up although they have been marked "done". This is a bug in 
  Nokias WRT library: entry.Status sometimes is undefined.
- real transparent background: I haven't found a way todo this yet. All the 
  widgets that have transparent background are no WRT widgets. Nokia?


License:
--------
This software is open source and licensed under the GPLv3. See License.txt 
for details.


Changelog:
----------
1.0 (2009-08-25) by cochambre
  - initial release by cochambre
1.01 (2009-08-25) by cochambre
  - fix some language localizations
1.02 (2009-08-27) by cochambre
  - jquery library removed (ram footprint reduction, about 1 mb now)
  - displaying ToDos from current day
  - calendar is loaded up to 2 months ahead of current day (ram footprint 
    reduction)
  - calendar app launches and closes much faster
  - more explicit error messages (post them here if you get one)
1.10 (2009-08-27) by Oxidative
  - Only 4 lines per widget, also use the bigger default font and a bigger 
    font size
  - added icons to easier distinguish between todos, meetings, birthdays etc
  - removed the big icon and the today's date info as this info is already 
    present on the homescreen
  - format months as numbers instead of text to give more room for the actual
    event text
  - display location if set in meetings
  - only update once per hour. But at the same time, react instantly on any 
    calendar changes made by the user. This is done using a callback. Should 
    save a lot of battery
  - display all todos from within the last year, if they are not marked as 
    "done". The original version will only display todos that have a 
    termination time in the future.
1.11 (2009-08-27) by Oxidative
  - added fix suggested by yves: use InstanceStartTime instead of StartTime 
    if available
  - use a <table> to align columns instead of loose <div> boxes
  - output line number in case of an error. This should help debugging 
    problems
  internals for developers:
    - added changelog to keep track of changes more easily
    - added switch (var panelNum) so the same code can be used for both, 
      "ComingNext" and "ComingNextB" widgets
1.12 (2009-08-28) by Oxidative
  - support for all date formats (YYYY-MM-DD, DD-MM-YYYY, MM-DD-YYYY)
  - format dates and times as 01.01 instead of 1.1
  - output more details to error log if JavaScript logging is enabled in web 
    browser
  - added variable to enable/disable ToDos in the event list
  - added variable to define the number months to include in the event list
1.13 (2009-08-28) by Oxidative
  - support for ToDos without dates
  - support for events without summary
  - fixed date format parsing for MM-DD-YYYY (finally ;-))
  - fixed months beeing off by 1
1.14 (2009-08-28) by Oxidative
  - support for fake transparent backgrounds.
1.15 (2009-08-30) by Oxidative
  - added separate Readme.txt
  - use the date format defined by the system (e.g. "31.12" or "12.31")
  - show a colored "Today" for the current day instead of full date
  - added options for showTodayAsText, todayText, dateSeparator and
    weekDayLength. These options can be found at the begin of index.html
  - added CSS classes for weekday, date, time and description so you can 
    customize everything very easily. Moved these CSS definitions to the
    begin of index.html so they are easy to spot.
  - fixed table alignment for very long event descriptions
  - comingNext is now licensed under the GPLv3
1.16 (2009-08-31) by Oxidative 
  - applied patch by pcmoore: Fixed a bug where all times are reported as 
    "AM" regardless of the actual event time
  - applied patch by pcmoore: new option to define which calendar app to 
    start when clicking the widget (calendarApp). By default this is the 
    buildin calendar, but you can run Epocware Handy Calendar or any other 
    app.
  - 5 new options: showNowAsText, nowText, dateFormat, updateDataInterval
    and calendarApp
  - events that last for multiple days will now properly show "Today"
  - if an event is currently taking place, display "Now" instead of the
    event staring time. This behaviour can be disabled with the 
    showNowAsText option. You can change the color of the "Now" text by
    changing the .now CSS class
  - users can now configure the update interval. The default setting is now
    5 minutes. This should not use too much battery, but at the same time
    keep the "Now" text up-to-date
  - added option to force a specific date format. dateFormat='auto' 
    (default) will use your phone's setting, 'DDMM' will display day first, 
    'MMDD' will display month first.
1.17 (2009-09-02) by Oxidative
  - fixed anniversaries for today not showing
  - new option "eventsPerWidget": with this you can define the number of 
    events that will be shown for each widget.
  - added new CSS class "icon": change this to modify the icon size (very
    useful if you want to change the number of events)
1.18 (2009-09-04) by Oxidative
  - fixed ToDos being shown although includeTodos=false was set
  - fixed ToDos being shown twice
  - show text "No further events within 2 months" if there are no events
    in the list. This behaviour and the text can be changed in the settings
1.19 (2009-09-04) by Oxidative
  - refixed problems that 1.18 should have solved (todos not showing, entries 
    showing twice)
1.20 (2009-09-05) by Oxidative
  - new project website at http://sourceforge.net/projects/comingnext
  - fixed memos/anniversaries showing although they have already passed
  - don't display weekday if date is 'Today'
  - changed default 'Now' color to #ff00ff to make it different from the 
    'Today' color
  - patch by pcmoore:
    - Fix problem with appointments starting at 12p where they
      would display as starting 12h later (midnight the following day)
    - Add a new feature to only display the time for events happening today 
      and only the date for events beyond today (showCombinedDateTime)
    - Add a new feature to disable showing the location of appointments 
      (showLocation)